home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / a / a_funk / packet1.tos / MONA_ST / MONA_ST.TXT < prev    next >
Encoding:
Text File  |  1995-05-01  |  35.1 KB  |  779 lines

  1. >>> MonA-ST <<<
  2. ~~~~~~~~~~~~~~~
  3.  
  4. (v1.00  5.10.1993 by Manfred Tönges, DL8WM)
  5.  
  6.  
  7. Programm-Dokumentation
  8. ======================
  9.  
  10. MonA-ST   duerfte   einigen  Atari-Usern  schon als MonA von DOSen her
  11. bekannt   sein,   die   Originalversion   hiervon  stammt   von
  12. Thorsten Altmaier (DH1PAA). Beide Programme erlauben das Extrahieren
  13. und Zusammenfassen von Info-Frames aus  einer  Packet-Radio-Monitor-
  14. Mitschrift  sowie  das  Erstellen von Verbindungs-Statistiken.
  15.  
  16.  
  17. Wozu das Ganze?
  18. ---------------
  19.  
  20. Auf  vielgenutzen Digis (wie zum Beispiel DB0DA in meiner Naehe)  ist
  21. fast staendig Betrieb. Fast immer liest gerade irgendjemand irgendetwas
  22. aus  einer  Mailbox  aus.  Und  nicht  selten werden die gleichen
  23. Mails  wieder  und  immer  wieder  von  verschiedenen  OM's
  24. ausgelesen, was  zu einer sehr starken Link- und Digibelastung fuehrt.
  25.  
  26. Hier  kann MonA Abhilfe schaffen. Die gaengigen Packet-Radio-Programme
  27. erlauben     das     Mitschreiben   des   Monitors   (aller   auf der
  28. Digi-Ausgabe gehoerten Daten) auf die Festplatte (Diskette). Auf stark
  29. ausgelasteten  Digis  fallen  dabei pro Tag mehrere Megabyte an Daten
  30. an,  in  denen  etliche  QSOs, Mailbox-Files und Binaerdaten enthalten
  31. sind.
  32.  
  33. Gibt  man  dieses  Monitorfile nun MonA zu 'futtern', extrahiert MonA
  34. daraus  die gewuenschten Verbindungen und schreibt sie auf die Platte,
  35. wo  sie  zur  Weiterverwertung z.B. durch 7Plus zur Verfuegung stehen.
  36. Auf diese Weise erhaelt man rein passiv ohne Sendetaetigkeit eine Menge
  37. an  Mails, die  man  sonst vielleicht selbst ausgelesen haette, gratis
  38. frei Haus.
  39.  
  40. 'Ueberfluessig'  hoere  ich  die  DP-User  sagen. Ich gebe zu, sie haben
  41. nicht  ganz Unrecht. Die Idee zu MonA entstand in Prae-DP-Zeiten. Aber
  42. DP-User     brauchen     MonA   ja    nicht   zum   Extrahieren   von
  43. Mailboxfiles   zu   verwenden,  vielleicht  aber  zum  Erstellen  der
  44. Verbindungsstatistik oder einfach zum nachtraeglichen Lesen von QSOs.
  45.  
  46.  
  47. Weiche und harte Voraussetzungen:
  48. ---------------------------------
  49.  
  50. > MonA-ST verarbeitet zur Zeit *nur* Monitorfiles, die das WA8-Header-
  51. > Format beherrschen. Das sind z.B. SP, DP, PacketMaster, ...
  52. > Allerdings muss das WA8-Header-Format auch eingeschaltet sein (geht
  53. > z.B. bei SP mit der Zeile "WA8=1" im Config-File).
  54.  
  55. Hardware-Voraussetzungen  gibt  es  fuer  MonA-ST keine. Es sollte mit
  56. wirklich  *allen*  Betriebssystem/Hardware-Zusammensetzungen  zurecht
  57. kommen (bekannt ist mir nur, dass es bei den Farb-Modi einiger
  58. Graphik-Karten zu Problemen kommen kann).
  59.  
  60. Im  Gegensatz zu MonA fuer DOSen ist MonA-ST ein Programm mit
  61. Oberflaeche (voll in GEM eingebunden).
  62.  
  63. Die Groesse des Monitorfiles stellt kein Problem dar, zumindest beim
  64. Extrahieren von Info-Frames nicht. Die Monitor-Datei kann beliebig
  65. lang sein. Beim Erstellen von Verbindungslisten wird pro Verbindung
  66. ein gewisser Speicherplatz benoetigt. Die maximale Anzahl an QSOs laesst
  67. sich frei bestimmen, die Obergrenze ist durch den freien Speicher
  68. bestimmt siehe 'Config' (18) . Bei Erstellung von MHeard-Listen aus
  69. Monitor-Files ab ca. 2 MB Groesse sollte man allerdings ernsthaft in
  70. Erwaegung ziehen, in der Zwischenzeit einen Kaffee trinken zu gehen
  71. (gilt zumindest fuer 8MHz-ST-User, beim STE/TT/Falcon duerfte das schon
  72. wieder anders aussehen...).
  73.  
  74.  
  75. Das Uebliche:
  76. -------------
  77.  
  78. MonA-ST wurde in 'GFA-Basic 3.5' geschrieben, zur Beschleunigung
  79. sind jedoch einige Assembler-Programmteile eingebunden. MonA-ST
  80. benutzt die GFA-FlyDial-Routinen von Gregor Duchalski.
  81. MonA-ST kostet nichts, die Rechte am Programm verbleiben jedoch
  82. vollstaendig beim Autor.
  83. Ein Funktionieren wie in dieser Doku beschrieben wird nicht
  84. garantiert. Fuer irgendwelche direkten oder indirekten Schaeden, die
  85. durch die Benutzung von MonA-ST entstehen oder entstanden sein
  86. koennten, kann keine Verantwortung uebernommen werden. Also: Was auch
  87. passiert, der User ist grundsaetzlich selber schuld!
  88. Mni Tnx an Toast (DG5FBT) fuer die Unterstuetzung beim Assembler, Thor
  89. (DH1PAA) fuer die Orginalversion und viele Tips, und Gregor Duchalski
  90. fuer die schoenen FlyDials.
  91.  
  92.  
  93. Alles, was dazu gehoert:
  94. -----------------------
  95. In dem Archiv 'MONA-ST.LZH' befinden sich folgende Dateien:
  96.         -  MONA_ST.PRG          das Programm
  97.         -  MONA_ST.DOC          diese Dokumentation
  98.         -  QUICK.TXT            Ultra-Kurz-Wegweiser
  99.  
  100. Die Weitergabe von MONA-ST ist nur komplett im Archiv erlaubt, so
  101. kann vermieden werden, dass nicht zueinanderpassende Dateien
  102. zusammenkommen.
  103. Eine Veraenderung an einer der beiliegenden Dateien und eine Verbreitung
  104. ueber PD-Versaende ist untersagt.
  105.  
  106.  
  107. Die Bedienelemente:
  108. -------------------
  109.  
  110. (1) "Info von <FromCall> nach <ToCall> extrahieren" :
  111. -----------------------------------------------------
  112. Fuegt alle Info-Frames aus der Monitor-Datei, die von 'FromCall'
  113. an 'ToCall' gerichtet sind, zusammen unter Beachtung der Frame-
  114. Nummern. Fehlt ein Frame, wird mit 'Framefolgefehler' hierauf
  115. hingewiesen. Fehlende Frames kommen aber normalerweise bei gut
  116. hoerbaren Digis kaum vor. Die Rufzeichen 'FromCall' und 'ToCall'
  117. werden am unteren Rand des Dialoges in die dafuer vorgesehenen Felder
  118. eingetragen. Monitor-Datei und Ziel-Datei werden mit einem Klick
  119. auf die Buttons 'Mon-File' und 'Ziel-File' bzw. mit dem dann
  120. erscheinenden Fileselektor ausgewaehlt. Wenn (7) eingeschaltet ist,
  121. wird nach dem Extrahieren der mit (18) eingestellte Viewer gestartet,
  122. um die extrahierten Daten anzusehen.
  123.  
  124. (2) "QSO-Uebersicht <FromCall> nach <???>" :
  125. -------------------------------------------
  126. Erstellt eine Liste aller Rufzeichen, die von <FromCall> Info-Frames
  127. erhielten (siehe auch (25)). Ist die Option "SSID beruecksichtigen"
  128. AUSgeschaltet, so wird in der Liste gegebenenfalls hinter dem gehoerten
  129. ToCall in Klammern ein SSID angezeigt. Dies bedeutet, dass die Verbindung
  130. 'FromCall-(SSID) > ToCall' gehoert wurde. Beispiel: FromCall=DB0AA,
  131. in der ToCall-Liste findet sich dann u.a. 'DC0BB    (-7)'. Das heisst,
  132. dass die Verbindung 'DB0AA-7 > DC0BB' gehoert wurde.
  133.  
  134. (3) "QSO-Uebersicht <???> nach <ToCall>" :
  135. -----------------------------------------
  136. Erstellt eine Liste aller Rufzeichen, die an <ToCall> Info-Frames
  137. abschickten (siehe auch (25)).
  138.  
  139. (4) "MHeard-Liste erstellen" :
  140. ---------------------------------
  141. Erstellt eine Liste aller gehoerten Verbindungen. Je nach Einstellung
  142. des Schalters (8) werden entweder nur 'FromCall' und 'ToCall'
  143. aufgelistet oder eine Liste mit folgenden Daten erstellt: 'FromCall',
  144. 'ToCall', Anzahl Control-Frames, Anzahl Info-Frames, Anzahl
  145. Info-Bytes, Binaerdatenanzeige (Sternchen unter 'B' = Binaerdaten),
  146. Startzeit, Endzeit, Verbindungsdauer (demnaechst noch mittlerer
  147. Datendurchsatz). Letztere Variante dauert natuerlich erheblich laenger
  148. (--> Kaffee trinken) (siehe auch (25)).
  149.  
  150. (5) "Ausgabe auf Drucker" :
  151. ---------------------------
  152. Funktion noch nicht implementiert, wird aber mal das tun, was der
  153. Name verspricht.
  154.  
  155. (6) "Ausgabe auf Ziel-File" :
  156. -----------------------------
  157. Wenn eingeschaltet, werden alle Text-Ausgaben (Extrahierte
  158. Info-Frames, MH-Liste) in das Ziel-File geschrieben.
  159.  
  160. (7) "Ausgabe auf Bildschirm" :
  161. ------------------------------
  162. Wenn eingeschaltet, werden alle Text-Ausgaben (Extrahierte
  163. Info-Frames, MH-Liste) in ein Fenster geschrieben.
  164.  
  165. (8) "MHeard-Liste mit Verbindungsdaten" :
  166. --------------------------------------------
  167. Wenn eingeschaltet, wird die MHeard-Liste in der ausfuehrlichen
  168. Form erstellt, ansonsten MH-Liste-light (siehe (4)).
  169.  
  170. (9) "extrahierte Info mit Verbindungsdaten" :
  171. ---------------------------------------------
  172. Wenn eingeschaltet, werden am Ende jeder Verbindung an die
  173. extrahierten Daten die Verbindungsdaten (Anzahl I-Frames, Anzahl
  174. Control-Frames usw.) mit ausgegeben.
  175.  
  176. (10) "Nachfrage bei Verbindungsende" :
  177. --------------------------------------
  178. Bei (1) (Info von <FromCall> nach <ToCall> extrahieren) wird am Ende
  179. der laufenden Verbindung nachgefragt, ob das Monitor-File nach
  180. weiteren Verbindungen zwischen den aktuellen Calls durchsucht werden
  181. soll.
  182.  
  183. (11) "Zusaetzliches Return einfuegen" :
  184. -------------------------------------
  185. Sollte, wenn mittels (1) Binaer-Daten extrahiert werden,
  186. ausgeschaltet sein. Erhoeht oftmal die Uebersichtlichkeit bei
  187. extrahierten QSO-Texten.
  188.  
  189. (12) "Sortierung: Keine" :
  190. --------------------------
  191. Gibt die ausfuehrliche MH-Liste unsortiert aus. Entspricht Sortierung
  192. nach der Startzeit.
  193.  
  194. (12) "Sortierung: Groesse" :
  195. --------------------------
  196. Gibt die ausfuehrliche MH-Liste nach der QSO-Groesse sortiert aus.
  197.  
  198. (13) "Sortierung: Call" :
  199. --------------------------
  200. Gibt die ausfuehrliche MH-Liste nach den Rufzeichen sortiert aus.
  201.  
  202. (14) "Sortierung: Dauer" :
  203. --------------------------
  204. Gibt die ausfuehrliche MH-Liste nach der Verbindungsdauer sortiert
  205. aus. Voraussetzung hierfuer ist natuerlich, dass der TimeStamp
  206. eingeschaltet ist (geht mit 'esc k 2') und somit im
  207. Monitor-Mitschnitt ueberhaupt Uhrzeiten auftauchen.
  208.  
  209. (15) "I-Bytes min" :
  210. --------------------
  211. Nur Verbindungen, bei denen die Info-Daten mehr als ___ Bytes
  212. betragen, werden in die ausfuehrliche MH-Liste mit aufgenommen.
  213.  
  214. (16) "Editor" :
  215. -----------------
  216. Hiermit kann direkt aus MonA-ST ein Text-Editor gestartet werden,
  217. etwa zum Nacheditieren extrahierter Info-Frames.
  218. In der Kommandozeile wird dabei das Ziel-File uebergeben (kompletter
  219. Pfad). Nach verlassen des Editors kommt man wieder zurueck zu MonA-ST.
  220.  
  221. (18) "Config" :
  222. ---------------
  223. Texteditor / Viewer ('Text-Angucker') auswaehlen, sowie noch einige
  224. andere Einstellungen; erklaert sich eigentlich von selbst.
  225. "SSID beruecksichtigen": Wird bei FromCall bzw. ToCall ein Call *ohne*
  226. SSID eingegeben, und anschliessend eine ToCall-Liste (2) bzw. FromCall-
  227. Liste (3) angefordert, so werden bei *ausgeschalteter* SSID-Option
  228. alle Rufzeichen aufgelistet, die zum Source-Call mit beliebigem SSID
  229. passen. Beispiel: FromCall=DL0AA -> ToCall-Liste erstellen (2), wobei
  230. "SSID beruecksichtigen" AUS ist -> es werden alle Verbindungen
  231. 'DL0AA-? to <???>' gesucht, wobei '-?' ein beliebiges SSID oder
  232. auch gar keins sein darf. Ist hingegen "SSID beruecksichtigen"
  233. EINgeschaltet, so werden *nur* die ToCalls gesucht, die DL0AA *ohne*
  234. SSID eine Verbindung hatte. Klar?
  235.  
  236. (19) "Info" :
  237. -------------
  238. Obligatorische Programminfo.
  239.  
  240. (20) "Save CFG" :
  241. -----------------
  242. Konfiguration von MonA-ST abspeichern. Dies geschieht in dem Pfad,
  243. von dem MonA-ST gestartet wurde. Dort muss auch die
  244. "MONA_ST.INF"-Datei liegen, damit sie beim Programmstart geladen
  245. wird.
  246.  
  247. (21) "Quit" :
  248. -------------
  249. Verlassen des Programms.
  250.  
  251. (22) "Start" :
  252. --------------
  253. Beginnen mit dem Bearbeiten des Monitorfiles gemaess den eingestellten
  254. Optionen.
  255.  
  256. (23) "Monitor-File" :
  257. ---------------------
  258. Auswahl des Monitor-Files. Ist kein Monitorfile gewaehlt, so erscheint
  259. beim Starten mit (22) erst der Fileselector zum Bestimmen des
  260. Monitor-Files.
  261.  
  262. (24) "Zielfile" :
  263. -----------------
  264. Auswahl der Zielfiles. Richtig, Plural. Denn es gibt 2 Zielfiles, je
  265. eins fuer MH-Listen und eins fuer extrahierte Info. Je nachdem, welcher
  266. der RadioButtons (1)-(4) 'gedrueckt' ist, ist diese Taste (24) fuer das
  267. MH-Listen-Zielfile oder das Info-Zielfile zustaendig.
  268. In diese Files werden die von MonA-ST erzeugten Texte geschrieben
  269. (eben besagte MH-Listen und extrahierte Infos). Wenn (6) eingeschaltet
  270. ist, und kein Zielfile bestimmt wurde, erscheint beim Starten mit (22)
  271. zunaechst der Fileselector zum Bestimmen des Zielfiles.
  272.  
  273. (25) Dialog "QSO-Uebersicht" :
  274. -----------------------------
  275. Hierhin gelangt man, wenn man eine Qso-Uebersicht mit (2) oder (3)
  276. oder eine MH-Liste-light mit (4) bestellt hat. Im Fenster werden alle
  277. gefundenen Rufzeichen / Verbindungen angezeigt. Rauf/Runterscrollen
  278. wie gewohnt. Wird ein Eintrag mit OK oder Doppelklick ausgewaehlt, so
  279. werden die entsprechenden Rufzeichen in den Hauptdialog bei
  280. "FromCall" bzw. "ToCall" uebernommen.
  281.  
  282. (26)-(29) "Zeige To-Liste", "Zeige From-Liste", "Zeige Info",
  283. -------------------------------------------------------------
  284.           "Zeige MH-Liste"
  285.           ----------------
  286. Wenn mit (1)-(4) schon  ein Monitorfile bearbeitet wurde, wird der
  287. entsprechende "Zeige"-Eintrag anwaehlbar dargestellt. Durch Anklicken
  288. gelangt man in den Dialog "QSO-Uebersicht" (25). Bei "Zeige MH-Liste"
  289. wird die ausfuerhliche MH-Liste gezeigt, sofern vorhanden, ansonsten
  290. die MH-Liste 'light'. Wenn zwischen dem Erstellen der langen MH-Liste
  291. und dem Anzeigen mittels (29) "Zeige MH-Liste" die Sortierung
  292. (12)-(14) oder die minimale Byte-Anzahl (15) veraendert wurde, wird
  293. vor dem Anzeigen die MH-Liste neu erstellt.
  294.  
  295.  
  296. Sonstiges :
  297. -----------
  298. Ein Druecken der Taste 'Escape' fuehrt zm Anhalten der momentanen
  299. Funktion (d.h. Erstellen von Info-Extrakten oder Verbindungslisten).
  300. Mit der auftauchenden AlertBox wird entschieden, ob weitergemacht oder
  301. abgebrochen wird. Keine Panik, wenn nicht *sofort* nach 'Escape'
  302. die Unterbrechung kommt, das hat schon seine Richtigkeit. Einfach
  303. einen kleinen Moment Geduld.
  304.  
  305. Zu Problemen kann es kommen, wenn ein bestehendes Monitorfile nach
  306. Beendigen des Packet-Programmes zu einem spaeteren Zeitpunkt wieder
  307. geoeffnet wird und erneut Monitor-Daten hineingeschrieben werden.
  308. Beispiel: Im 'alten' Teil des Monitorfiles wurde die Verbindung
  309. 'DB0ABC to DB0XYZ' gefunden, aber nicht deren Ende, da das
  310. Packet-Prog vor dem Ende dieser Verbindung abgeschaltet wurde. Im
  311. 'neuen' Teil des Monitorfiles ist nun wieder eine Verbindung 'DB0ABC
  312. to DB0XYZ' vorhanden, die aber nicht notwendig die gleiche ist wie
  313. vorher. In diesem Fall denkt MonA-ST aber, es sei die gleiche
  314. Verbindung. Es kommt bei der MH-Liste dann u.U. zu falscher
  315. Verbindungsdauer-Anzeige und beim Info-Extrahieren zur Anzeige von
  316. Frame-Folge-Fehlern. Besser also bei jedem Neustart des
  317. Packet-Programms ein neues Monitor-File oeffnen oder das alte vorher
  318. entsorgen (=loeschen).
  319.  
  320. Jeder Button in den Dialogen, der ein unterstrichenes Zeichen enthaelt,
  321. kann statt eines Mausklicks auch mittels der ALTERNATE-Taste in Verbindung
  322. mit dem unterstrichenen Zeichen bedient werden. "Info" kann auch durch
  323. HELP, "Config" auch durch UNDO bedient werden. Die vier Buttons
  324. "Zeige Info", "Zeige MH-Liste", "Zeige From-Liste", "Zeige To-Liste"
  325. lassen sich auch mit F1-F4 bedienen.
  326.  
  327. Wie ueblich zeigt die 'Busy Bee' an, wenn der Rechner gerade
  328. ausgelastet ist.
  329.  
  330. Zum Thema Multitasking: Prinzipiell ist MonA-ST unter Multitasking-
  331. Betriebssystemen lauffaehig. Es wurde jedoch aus Geschwindigkeitsgruenden
  332. darauf verzichtet, bei *jedem* Durchlauf der Haupt-Arbeits-Schleife
  333. einen EVNT-Aufruf vorzunehmen.
  334.  
  335. Fuer Besitzer eines TOS < 1.4 steht leider nur ein FileSelektor ohne
  336. Titelzeile zur Verfuegung. MonA-User ohne Festplatte habens mit
  337. MonA-ST nicht ganz so gut: Da relativ oft auf das Source-Laufwerk
  338. zwecks Daten-Nachladung zugegriffen wird, sollte man hier schon etwas
  339. Geduld mitbringen (-> Kaffee trinken). Auch sind mit nur einem
  340. DD-Laufwerk den Extraktionsorgien physikalische Grenzen gesetzt
  341. (hoffentlich kommt der Alert "Kein Platz mehr auf Laufwerk XYZ!" nicht
  342. allzu oft hi).
  343.  
  344. Fuer OMs, die nicht wissen, was ein 'Viewer' ist: 'Viewer' nennt man
  345. Programme, die (Ascii-)Texte (oder komfortablere Exemplare dieser
  346. Gattung auch Bilder, Resourcen, usw.) anzeigen koennen. Um in MonA-ST
  347. die extrahierten Infos anzuschauen, benoetigt man einen solchen
  348. Viewer. Da es genug derer gibt, hab ich es mir erspart, einen selbst
  349. zu schreiben. '1ST_VIEW' von Guido Vollbeding ist fuer unseren Zweck
  350. gut geeignet, es ist schoen kurz und ist FreeWare. Daher habe ich
  351. '1ST_VIEW' als LZH-Archiv mit in die Box eingespielt.
  352.  
  353. Fragen, Anregungen und Kritik bitte an DL8WM @ DB0GE.
  354. Vy 73 de Manfred!
  355.  
  356. 12Oct93/1038 Subject: MonA-ST Programm-Info Bulletin ID: 12A304DB0GV
  357. Path: DB0RBS!DB0MWE!DB0LAN!DB0BOX!DB0HOF!DB0SON!DB0SIF!DB0GV
  358. de DL8WM @ DB0GV.#HES.DEU.EU to ATARI @ DL
  359.  
  360. MONA-ST.LZH  -  Programminfo
  361.  
  362. MonA-ST   dürfte   einigen  Atari-Usern  schon als MonA von DOSen her
  363. bekannt sein, die Originalversion hiervon stammt von DH1PAA.
  364. MonA-ST erlaubt das Extrahieren und Zusammenfassen von Info-Frames
  365. aus  einer  Packet-Radio-Monitormitschrift  sowie  das  Erstellen von
  366. Verbindungs-Statistiken.
  367. MonA-ST ist *keine* DOSen-nach-ST-Portierung, sondern ein 'richtiges'
  368. Atari-Programm, was dementsprechend auch voll in GEM eingebunden ist!
  369.  
  370. Wozu das Ganze?
  371. Auf  vielgenutzen Digis ist fast ständig Betrieb. Fast immer liest
  372. gerade irgendjemand irgendetwas aus  einer  Mailbox  aus.  Und  nicht
  373. selten werden die gleichen Mails  wieder  und  immer  wieder  von
  374. verschiedenen  OM's ausgelesen, was  zu einer sehr starken Link- und
  375. Digibelastung führt.
  376.  
  377. Hier  kann MonA Abhilfe schaffen. Die gängigen Packet-Radio-Programme
  378. erlauben     das     Mitschreiben   des   Monitors auf die Festplatte.
  379. Auf stark ausgelasteten  Digis  fallen  dabei pro Tag mehrere Megabyte
  380. an Daten an,  in  denen  etliche  QSOs, Mailbox-Files und Binärdaten
  381. enthalten sind.
  382.  
  383. Gibt  man  dieses  Monitorfile nun MonA zu 'futtern', extrahiert MonA
  384. daraus  die gewünschten Verbindungen und schreibt sie auf die Platte,
  385. wo  sie  zur  Weiterverwertung z.B. durch 7Plus zur Verfügung stehen.
  386. Auf diese Weise erhält man rein passiv ohne Sendetätigkeit eine Menge
  387. an  Mails, die  man  sonst vielleicht selbst ausgelesen hätte, gratis
  388. frei Haus.
  389.  
  390. Weiterhin kann man mit MonA u.a. feststellen, wer mit wem von wann bis
  391. wann ein QSO hatte und wieviele Daten übertragen wurden. Man kann das
  392. MHeard-Liste nennen, aber Verbindungsstatistik klingt besser :-).
  393.  
  394. > In der vorliegenden v1.0 müssen Monitor-Files allerdings im
  395. > ***WA8-Modus*** (lange Header) erstellt werden!!!
  396. > Falls das Packet-Programm dies nicht beherrscht, ist das
  397. > Auslesen sinnlos!
  398.  
  399. Und wer mit DP schon Mailboxfiles mitschneidet, den mag vielleicht
  400. die Verbindungsstatistik von MonA interssieren...
  401.  
  402. Einen Viewer ('Ascii-Text-Angucker') sollte man zur Hand haben. Für
  403. die, die keinen haben, habe ich "1STVIEW" eingespielt. Eine
  404. Festplatte sowie ein Graphik-Beschleuniger (z.B. "NVDI") sind sehr
  405. empfehlenswert. Ansonsten fallen mir keine Hard/Software-
  406. Voraussetzungen ein...
  407.  
  408. Vy 73 de Manfred, DL8WM @ DB0GE
  409.  
  410.  
  411. Text zur PC-Version MONA.EXE:
  412.     חלללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללל†
  413.     ´                                                                      ´
  414.     ´       ףףף       ףףף       ףףףף       ףףף      ףף      ףףףף           ´
  415.     ´       ףףףף     ףףףף     ףף    ףף     ףףףף     ףף    ףף    ףף         ´
  416.     ´       ףף ףף   ףף ףף    ףף      ףף    ףף ףף    ףף   ףף      ףף        ´
  417.     ´       ףף  ףף ףף  ףף   ףף        ףף   ףף  ףף   ףף   ףף      ףף        ´
  418.     ´       ףף   ףףף   ףף   ףף        ףף   ףף   ףף  ףף   ףףףףףףףףףף        ´
  419.     ´       ףף    ף    ףף   ףף        ףף   ףף    ףף ףף   ףף      ףף        ´
  420.     ´       ףף         ףף    ףף      ףף    ףף     ףףףף   ףף      ףף        ´
  421.     ´       ףף         ףף      ףףףףףף      ףף      ףףף   ףף      ףף        ´
  422.     ´                                                                      ´
  423.     ´                            Version 1.1a                              ´
  424.     ´                                                                      ´
  425.     ´                   Packet-Radio-Monitor-Auswertung                    ´
  426.     ´                                                                      ´
  427.     ´                     *** Free for Ham-Use ! ***                       ´
  428.     ´                                                                      ´
  429.     ´                     Copyright (c) Jan-Juni 1993                      ´
  430.     ´                by Thorsten Altmaier, DH1PAA @ DB0GV                  ´
  431.     ´                                                                      ´
  432.     זלללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללללל¶
  433.  
  434. IBM @DL de:DH1PAA 11.06.93 18:52  90   2722 Bytes
  435. MONA#.EXE Info: PR-Monitor-Auswertung *** Bulletin-ID: 116351DB0GV ***
  436. 930611/1852z DB0HOM, 930611/1850z DB0SIF, 930611/1758z DB0GV
  437. de DH1PAA @ DB0GV.#HES.DEU.EU to IBM @ DL
  438.  
  439. MonA (= Monitor-Auswertung)  (c) Jan-Juni 1993 by DH1PAA * Freeware !
  440.                                                 Rüsselsheim, 11.06.93
  441. Hallo PR-Freaks,
  442. jetzt hat man mich doch überredet, einmal ein Programm einzuspielen,
  443. an dem ich schon einige Monate am tüfteln bin. Wohl jede YL bzw.
  444. jeder OM, die/der Packet mit dem PC macht, kann mit MonA etwas anfangen.
  445.  
  446. Die öftere Benutzung von MonA führt aktiv zur Frequenzentlastung !!!
  447.  
  448. MonA (= Packet-Radio-Monitor-Auswertung) erlaubt das - ultimative -
  449. Zusammenfassen von QSOs, und zwar so, daβ kein (!) Nacheditieren der
  450. entstehenden Dateien notwendig ist. Es existiert definitiv zur Zeit
  451. kein vergleichbares Programm, welches mit so vielen Terminalprogrammen
  452. klar kommt ! (Ich hätte mir sonst die Mühe gespart, hi).
  453. MonA kann auch sehr gut zur Frequenzbeobachtung eingesetzt werden
  454. (Sysops), näheres siehe Programmdokumentation.
  455.  
  456. Es wurde (und wird) unter folgenden Gesichtspunkten entworfen:
  457.  
  458.      - Freeware (!)
  459.      - Verwendung von Monitor-Mitschriften vieler Programme
  460.        z.B. TOP, GP, THS, WinPR, SP, Baycom etc.
  461.      - lauffähig unter allen PCs/XTs/ATs/386...
  462.      - und unter allen Betriebssystemen (incl. Windows / OS2)
  463.      - Ausnutzung des AX25-Protokolls
  464.      - sehr viele Aufrufmöglichkeiten
  465.      - Schnelligkeit
  466.      - verfügbarer Quelltext (Pascal, Info an mich)
  467.  
  468. Das Archiv mona#.exe (lha 2.13) enthält folgende Dateien:
  469.      - mona.exe    komprimiertes Programm
  470.      - mona.doc    kleine Dokumentation
  471.      - mona.his    Entstehungsgeschichte, Tips und Tricks
  472.      - lesmich.doc diese Info
  473.  
  474. Als Kommandozeilenprogramm kann es sehr leicht mittels Batch-Dateien
  475. oder direkt vom Prompt aus bedient werden.
  476.  
  477. Es besteht kein Grund anzunehmen, daβ die eingespielte Version 1.1a
  478. fehlerfrei ist. MonA wurde jedoch einige Zeit von verschiedenen OMs
  479. getestet (denen ich hiermit recht herzlich Danke !). Falls irgendwo
  480. MonA nicht funktionieren sollte, bitte ich um entsprechenden Hinweis.
  481. Falls irgendein Wunsch offen ist, (z.B. Anpassung an irgendein exo-
  482. tisches Terminalprogramm), bitte ich ebenfalls um kurze Info, damit
  483. er in der nächsten Version eingebaut werden kann.
  484.  
  485. So, viel Spaβ mit MonA
  486.      es vy 73 de Thorsten, DH1PAA @ DB0GV (oder direkt via DB0ZDF)
  487.  
  488. ----------------------------------------------------------------------
  489.                          MonA  Version 1.1a
  490.                    Packet-Radio-Monitor-Auswertung
  491.            Version für DOS/Kommandozeilen-Version 11.06.93
  492.       Copyright (c) Thorsten Altmaier DH1PAA @ DB0GV, Jan-Juni 93
  493. --------------------------------------------------------------------
  494.  
  495. Beschreibung:
  496.  
  497. Dieses Programm erlaubt die Auswertung von Packet-Radio-Monitor-
  498. Dateien. Es werden die einzelnen Frames einer anzugebenden Verbin-
  499. dung zusammengefasst und in einer separaten Datei abgespeichert.
  500. Hierbei werden Framewiederholungen berücksichtigt ! Es kann eine
  501. MHeard-Liste, in Form einer informativen Statistik, aus der Monitor-
  502. datei gewonnen werden.
  503.  
  504. Die Anwendung dieses Programms kann zur spürbaren Linkentlastung
  505. führen. Wenn ein netter OM zum x-ten mal z.B. den DL-Rundspruch oder
  506. das neueste Programm aus einer BBS downläd, braucht man es selbst
  507. nicht zu tun. Denn läβt man jetzt immer den Monitorsave an, so kann 
  508. man aus der so gewonnenen Monitordatei "en passante" die neuesten 
  509. Infos durch MonA bequem extrahieren.
  510.  
  511. Den typischen "Dauer-BBS-Melkern" (tja, die gibt's leider) sei MonA
  512. besonders empfohlen, da durch die geringere Linkbelastung auch mal
  513. die anderen User "zu Potte" kommen.
  514.  
  515. Den Sysops (oder anderen Interessierten) kann MonA als Hilfsmittel
  516. zur Frequenzbeobachtung dienen.
  517.  
  518. Voraussetzungen:
  519.  
  520. Die Monitordatei kann eigentlich auf jede Art erzeugt worden sein.
  521. Sowohl WA8DED-Header, als auch verkürzte SP-Header, Baycom, als auch
  522. TOP-Dateien werden automatisch erkannt.
  523. Diese Version wurde ausführlich mit GP 1.5, SP 6.11, THS, Baycom,
  524. WinPR sowie TOP getestet. Als Zeilentrennung wird CR+LF erwartet. Es
  525. ist zweckmäβig bei TNCs Die Zeitausgabe mit "ESC K 2" einzuschalten.
  526.  
  527. MonA läuft auf allen IBM-kompatiblen PCs/XTs/ATs usw. unter den
  528. üblichen Betriebssystemen (incl. OS/2). Es wird jedoch direkt in den
  529. Videospeicher geschrieben (evtl. Snow-Problem bei CGAs). MonA hätte
  530. gern rund 300 kByte Speicher, arbeitet jedoch auch mit weniger.
  531.  
  532. Aufruf:         MonA <Parameter>
  533.  
  534. Als Parametereinleitung ist "-" oder "/" möglich.
  535. Im folgenden steht ein Argument in spitzen Klammern (<>) als Platz-
  536. halter. Eckige Klammern kennzeichnen freiwillige Parameter. Die Klam-
  537. mern werden nicht mit eingegeben.
  538.  
  539. Als <Parameter> ist möglich:
  540. -?  Hilfe
  541.  
  542. -i <fmcall> <tocall> <monfile> [<destfile>] [<Optionen>]
  543.   Zusammenfassen aller Info-Frames von <fmcall> nach <tocall>
  544.   aus der Datei <monfile>. Es wird in die Datei <destfile> ge-
  545.   schrieben. Fehlt <destfile>, so wird auf den Bildschirm ge-
  546.   schrieben. Die angegebenen Rufzeichen müssen die SSID ent-
  547.   halten.
  548.   Wird für <fmcall> und/oder <tocall> ein Asterix "*" angege-
  549.   ben, so werden alle passenden Info-Frames ausgewertet.
  550.   Die Ausgabe kann jederzeit mittels der Escape-Taste unter-
  551.   brochen werden. Die Dateien werden dann noch ordentlich ge-
  552.   schlossen.
  553.  
  554. -h <fmcall> <tocall> <monfile> [<destfile>] [<Optionen>]
  555.   wie -i, jedoch werden die Headerinformationen mit ausgegeben.
  556.  
  557. -m <monfile> [<destfile>] [<Optionen>] [<RXB-Schranke>]
  558.   Alle Verbindungen aus der Datei <monfile> als Übersicht in die
  559.   Datei <destfile> schreiben. Fehlt das zweite Argument, erfolgt
  560.   die Ausgabe auf den Bildschirm. Die Ausgabe kann jederzeit mit
  561.   der Space-Taste angehalten werden. Die Escape-Taste beendet das
  562.   Programm.
  563.   Die Ausgabe erfolgt sortiert nach Rufzeichen. Angezeigt werden
  564.   fmCall, toCall, Anzahl der Info-(I/UI)-Frames und der Supervi-
  565.   sor-Frames, die Byte-Anzahl der Info-(I/UI)-Frames. Waren in
  566.   einem Frame Binärdaten enthalten, so erscheint als nächstes ein
  567.   Asterix (*). Ist mit dem TNC-Kommando "ESC K 2" die Zeitausgabe
  568.   eingeschaltet, so wird die Empfangszeit des ersten und letzten
  569.   Frames einer Verbindung in der Liste eingetragen. Bei Baycom-
  570.   Dateien wird leider nur die Zeit ausgegeben.
  571.   Wird eine <RXB-Schranke> angegeben, so werden nur QSOs ange-
  572.   zeigt, deren Infobyte-Anzahl gröβer gleich dieser Schranke ist.
  573.  
  574. Als <Optionen> sind möglich:
  575. bei -i und -h:
  576. -a   Alle Frametypen werden verarbeitet
  577. -b   Frames von <toCall> nach <fmCall> werden verarbeitet
  578. -w   Der Informationsinhalt von I- und UI-Frames wird
  579.      unterdrückt
  580. bei -m:
  581. -g   Es wird die MHeard-Liste nach der Infobyte-Anzahl absteigend
  582.      sortiert ausgegeben.
  583. -z   Es wird die MHeard-Liste nicht sortiert. Dies kommt einer
  584.      Sortierung nach der Zeit gleich.
  585. immer:
  586. -q   Programmeldungen (mit Ausnahme von Aufruffehlern) werden
  587.      unterdrückt
  588. -o   Zieldateien werden, falls vorhanden, überschrieben. Ohne
  589.      diese Option, werden bereits vorhandene Zieldateien nicht
  590.      überschrieben.
  591.  
  592. Hierbei ist <monfile> die mit einem beliebigem Terminalprogramm mit-
  593. geschriebene Monitordatei. Es sollte die Umlautwandlung ausgeschaltet
  594. sein (wg. 7plus-Infos).
  595. Als <destfile> ist jede beliebige Datei erlaubt (auch z.B. PRN), sie
  596. darf jedoch nicht mit einer Zahl im Namen beginnen.
  597. Die Reihenfolge der Optionen ist beliebig.
  598.  
  599. Das Programm kann jederzeit mit der Leertaste (Space) angehalten
  600. werden. In der rechten oberen Bildschirmecke erscheint dann <Pause>.
  601. Bei einem beliebigen Tastendruck fährt das Programm fort.
  602. Mit der Escape-Taste (ESC) kann das Programm auch zu jeder Zeit
  603. abgebrochen werden. Vorhandene Dateien werden dabei korrekt geschlos-
  604. sen.
  605.  
  606. Tritt ein Fehler auf, dann erfolgt eine entsprechende Mitteilung
  607. (beginnend mit '***').
  608. Wird 'Files ok.' ausgegeben, so konnten die Dateien erfolgreich
  609. geschlossen werden.
  610.  
  611. Erweiterungen:
  612.  
  613. Falls die Resonanz entsprechend ist, mach ich mal eine ausführliche
  614. Dokumentation (mit Beispielen und so) und wenn mal alle Bugs raus
  615. sind, bzw. alle Wünsche erfüllt, wird der Quelltext freigegeben.
  616.  
  617. Es wird eine Version in Turbo-Vision erstellt werden, sowie eine
  618. Version für Windows. Eine Version für Atari ist in Arbeit.
  619. Weitere Informationen (z.B. Quelltext) gibt's beim Autor:
  620.  
  621. Thorsten Altmaier
  622. DH1PAA @ DB0GV.DEU.EU
  623. Gemündener Straβe 10
  624. 6545 Mengerschied
  625. 55490 Mengerschied (ab 1. Juli)
  626.  
  627. Diese Software wurde mittels Borland's Turbo-Pascal 6.0 erstellt.
  628. Der Author ist ein registrierter Benutzer von Turbo Pascal 6.0
  629. und Turbo-Pascal for Windows 1.5.
  630.  
  631. MonA Ver. 1.1a                History                        
  632.       MonA -- Packet-Radio-Monitor-Auswertung (c) 1993 DH1PAA
  633.  
  634.  
  635. Ver ???    - Vorversion "SPM" im Juni 1992
  636.            - Zusammenfassung einer Verbindung
  637.  
  638. Ver 1.0a   - neue Erstellung und Umarbeitung der Unit MonUtil
  639.  
  640. Ver 1.0b   - neuer Programmaufruf
  641.  
  642. Ver 1.0c   - Fehler beseitigt:
  643.              - in Routine CallCheck Typprüfung auf tI eingefügt
  644.  
  645. Ver 1.0d   - Fehler beseitigt:
  646.              - Fiel das Frameende mit einem Zeilenende zusammen, so
  647.                wurde das Return verschluckt und es kam zu überlangen
  648.                Zeilen.
  649.                Dies läβt sich nicht vermeiden (bedingt durch Termi-
  650.                nalprogramm).
  651.                Es wurde jedoch ein Test auf überlange Zeilen einge-
  652.                fügt. Dieser prüft nun die Länge der ersten Frame-
  653.                Zeile (Konstante MaxZlnPos).
  654.                Nacheditieren ist, besonders bei 7plus-Mitschriften,
  655.                Framefolgefehler ausgenommen, nicht mehr nötig.
  656.  
  657. Ver 1.0e   - neuer Aufruf (Siehe MonA.DOC)
  658.            - Kommandozeilenparameter: -i, -h, -a, -b, -w, -o, -q, -?
  659.  
  660. Ver 1.0f   - Umstrukturierung (Units MonUtil, MonCtrl),
  661.            - Assembler-Teile zur Umgehung von Crt
  662.            - Kommentierung des Quelltextes
  663.  
  664. Ver 1.0g   - Tastendruck hält das Programm an, jede weitere Taste
  665.              läβt das Programm weitermachen
  666.            - Die Escape-Taste bricht das Programm ab. Vorhandene
  667.              Daten werden noch geschrieben.
  668.            - Fehler beseitigt:
  669.              - Prüfung auf REJ-Frames eingefügt
  670.            - neuer Parameter: -m
  671.              - Anzeige einer MHeard-List, sortiert nach Call
  672.              - Angezeigt werden:
  673.                - fmCall, toCall
  674.                - Anzahl der Info-Frames (I und UI)
  675.                - Anzahl der Supervisor-Frames (RR,REJ,SABM,DISC,DM)
  676.                - Anzahl der Info-Frame-Bytes
  677.            - Framefolgefehler werden nun in der Ausgabedatei
  678.              vermerkt ('*** Framefolgefehler ***').
  679.            - Fehler beseitigt:
  680.              - kein Laufzeitfehler mehr, wenn der Drucker aus ist
  681.              - Parameter -o beim Drucker nicht mehr nötig
  682.            - Fehler beseitigt:
  683.              - Parameter -i bzw. -h:
  684.                Wurde in einem QSOs ein disc gemacht und danach wieder
  685.                conn, so wurde ein Framefolgefehler angezeigt, wo
  686.                eigentlich keiner ist. Nun wird nach jedem empfangenem
  687.                UA-Frame die Framefolgefehler-Zählung zurückgesetzt.
  688.                (Variable NBegin in ScanMonFi)
  689. Ver 1.0h   - TNC-Zeit wird nun verarbeitet (ESC K 2)
  690.            - neu bei Parameter -m:
  691.                 - Es wird Datun und Zeit des ersten Frames einer
  692.                   Verbindung angegeben (falls TNC-Zeit eingeschaltet)
  693.                 - Falls die Ausgabe auf den Bildschirm erfolgt, so
  694.                   hält sie automatisch alle 20 Zeilen an.
  695.            - Fehler beseitigt:
  696.              - Parameter -h:
  697.                Bei überlanger Zeile erfolgt nun kein extra Zeilen-
  698.                vorschub mehr, wenn die Ausgabe auf dem Bildschirm
  699.                erfolgt
  700.  
  701. Ver 1.0i   - Es sind jetzt auch die verkürzten SP-Header erlaubt
  702.              (Config.sp: WA8=0). Ein Umschalten ist jederzeit möglich.
  703.              Das Format des Headers wird automatisch erkannt. Die soll
  704.              auch für spätere Erweiterungen (z.B. Baycom-Header) so
  705.              bleiben.
  706.            - In der MHeard-Liste (Option -m) wird jetzt angezeigt, ob
  707.              im entsprechenden QSO etwas binär übertragen wurde, also
  708.              z.B. 7plus-Daten. Ist das der Fall, dann erscheint vor
  709.              dem Datum ein Asterix (*).
  710.            - Fehler beseitigt:
  711.              - Wurde bei SP Multi-TNC-Betrieb gemacht, so wurden keine
  712.                Header erkannt.
  713.              - Enthielt ein Info-Frame keine Information, das passiert
  714.                leider, da einzelne Returns z.B. von SP verschluckt 
  715.                werden, so wurde in der MHeard-Liste eine falsche RXB-
  716.                Anzahl angegeben.
  717.              - Das Datum (ESC K 2) wird nun im DL-üblichen Format
  718.                TT.MM.YY angegeben.
  719. Ver 1.0j   - Neuer Aufruf bei -m:
  720.              - -m <monfile> [<destfile>] [<optionen>] [<RXB>]
  721.                Es kann zusätzlich eine minimale Info-Byte-Grenze <RXB>
  722.                angegeben werden, ab der Einträge in der Liste erschei-
  723.                nen. Ist z.B. <RXB>=10000, so werden alle Einträge
  724.                ausgegeben, deren Info-Byte-Anzahl mindestens 10000
  725.                beträgt.
  726.            - Neue Optionen bei -m:
  727.              - -g Liste wird absteigend nach der Anzahl der Info-Bytes
  728.                sortiert.
  729.              - -z Liste wird nicht sortiert. Dies entspricht einer
  730.                Sortierung nach der Zeit.
  731.              - Defaultmäβig wird, bei fehlender Option, wie bisher
  732.                aufsteigend nach Calls sortiert.
  733.            - Fehler beseitigt:
  734.              - Es wurden bei Multi-TNC-Betrieb keine SP-Header erkannt.
  735.              - Es wurde bei DL-Firmware ein falsches Datum berechnet.
  736.                Nun wird automatisch zwischen 04/22/93 und 22.04.93
  737.                unterschieden und nur im ersten Fall das Datum verändert.
  738. Ver 1.0k   - Neu: Baycom-Dateien können verarbeitet werden.
  739.            - Der Quelltext kann leicht durch neue "Header-Typen" er-
  740.              weitert werden.
  741.              (MonUtil: Routinen IsHeader und GetFrHeader)
  742.              Verschiedene Headertypen dürfen auch in einer Datei ent-
  743.              halten sein. 
  744.            - Bei -h wird jetzt der Headertyp in der Headerzeile aus-
  745.              gegeben.
  746. Ver 1.0l   - Neu: TOP-Dateien können verarbeitet werden.
  747.            - Mit WinPR 2.17 getestet. OK.
  748.            - Durch eine Änderung in den Dateizugriffen (dynamische Bele-
  749.              gung von je zwei Dateipuffern a 64k) ist MonA jetzt ca.
  750.              50 % schneller geworden !
  751.            - Option -m: es wird jetzt auch die Zeit des letzten gehörten
  752.                         Frames einer Verbindung angezeigt.
  753. Ver 1.1a   - Erstes freigegebenes Release
  754.            - Programm enthält kein Debug-Code mehr (etwas schneller)
  755.            - Statusmeldung geändert: Anzeige des Bearbeitungsstands
  756.              jetzt durch einen "progressbar".
  757.            - Die Programm-Laufzeit wird jetzt ausgegeben (dadurch Ge-
  758.              schwindigkeitsvergleich möglich)
  759.            - Option -i/-h:
  760.              -  Bug entfernt, klappt jetzt auch bei UI-Frames
  761.  
  762. Erklärung des Autors:
  763.  
  764. Dieses Programm ist Freeware. Überlegen Sie aber mal, nach einiger
  765. Benutzung, wie viele Stunden "Mailbox-Melken" das Programm Ihnen er-
  766. spart hat. Der Autor ist Student und wird sich über eine kleine
  767. Zuwendung freuen.
  768. MonA darf von Funkamateuren frei verwendet und kopiert werden.
  769. Das Programm erhebt keinen Anspruch auf Vollständigkeit oder Funk-
  770. tionsweise.
  771. Hinweise, Erweiterungsvorschläge und Beifallsbekundungen (hi) bitte
  772. in meiner Box hinterlassen.
  773.  
  774. viel Spaβ es vy 73
  775. de Thor, DH1PAA @ DB0GV (oder direkt via DB0ZDF)
  776.  
  777. Rüsselsheim/Mengerschied, 11.06.93
  778.  
  779.